Skip to content

refactor(agent): factor CLAUDE.md from 213→56 lines with prompts submodule (RFC-001)#15

Open
CodeMonkeyCybersecurity wants to merge 1 commit intomainfrom
refactor/14-claude-md-factoring
Open

refactor(agent): factor CLAUDE.md from 213→56 lines with prompts submodule (RFC-001)#15
CodeMonkeyCybersecurity wants to merge 1 commit intomainfrom
refactor/14-claude-md-factoring

Conversation

@CodeMonkeyCybersecurity
Copy link
Owner

Summary

  • CLAUDE.md: 213 → 56 lines (−74%)
  • Added third_party/prompts git submodule (cybermonkey/prompts)
  • Governance contracts replaced with @third_party/prompts/ @import references

Changes

File Change
CLAUDE.md Replaced 213-line monolith with 56-line thin proxy
.gitmodules Added third_party/prompts submodule
third_party/prompts New submodule at ssh://git@vhost7:9001/cybermonkey/prompts.git

Why

Per RFC-001: governance contracts were copy-pasted inline. This converts helen to a thin proxy that @imports governance from the upstream cybermonkey/prompts submodule. Only helen-specific context remains: Hugo static site commands, architecture notes (Extended 0.128.0+, SCSS via Hugo Pipes, Docker on port 8009), and cross-repo inventory.

Helen had no tests so no test coverage change.

Test plan

  • hugo --minify builds successfully
  • git submodule status third_party/prompts shows current SHA (no + prefix)
  • Spot-check contract imports resolve: @third_party/prompts/GOVERNANCE-SUMMARY.md

References

🤖 Generated with Claude Code

…odule

Replace 213-line CLAUDE.md with a 56-line thin proxy that:
- Retains essential commands and helen-specific identity (Hugo static site)
- Delegates governance contracts to @third_party/prompts/ @imports
- Adds cybermonkey/prompts as third_party/prompts submodule

Closes #14

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1215585c8c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -0,0 +1,3 @@
[submodule "third_party/prompts"]
path = third_party/prompts
url = ssh://git@vhost7:9001/cybermonkey/prompts.git

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Replace internal-only submodule remote

The new submodule URL points to ssh://git@vhost7:9001/..., which is only resolvable from environments that can reach that internal host and have SSH auth configured; outside that context, git submodule update --init cannot fetch third_party/prompts, leaving all @third_party/prompts/... governance references in CLAUDE.md unresolved for fresh and existing clones. In this checkout, git ls-remote ssh://git@vhost7:9001/cybermonkey/prompts.git HEAD fails with Could not resolve hostname vhost7, so this regression is immediately reproducible.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

refactor(agent): factor CLAUDE.md from 213→56 lines with prompts submodule

1 participant